home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / cmod117.zip / CMOD.DOC < prev    next >
Text File  |  1994-07-04  |  7KB  |  148 lines
  1.  
  2.                        CapaMod v1.17 documentation file
  3.  
  4.            Copyright (C) 1993,1994 Heikki Ylinen ( flap / Capacala )
  5.  
  6.  
  7.      1. HISTORY AND TECHNICAL INFO ETC.
  8.  
  9.    CapaMod is a 4,6 and 8 channel Pro/FastTracker module player. The reason
  10.  why I made this program is that there isn't a single good module player for
  11.  the PC. I mean, all players contain many bugs and there isn't a single player
  12.  which supports all the ProTracker 1.1b effects. In the EFFECT.TXT file you can
  13.  find a table containing effect info on three popular players and CapaMod. Just
  14.  simply look at it and say which player is the best in that matter. I have in-
  15.  cluded only these three players because DMP is so popular and GusMOD and JMP
  16.  are relatively good players. Of course I have been testing other players also
  17.  but I haven't included them in the table because of their insufficient effect 
  18.  support. For example players such as MDP (PSi's player), WOW, ZZPlay, GUSPlay,
  19.  Galaxy Module Player and Inertia Player do not usually support effects like 
  20.  DelayPattern and JumpToLoop. Not to speak about how they support normal ef-
  21.  fects such as Vibrato. Tremolo is also one effect that is played correctly
  22.  with only few players. But with CapaMod everything is otherwise. Except for
  23.  the support of effect Invert Loop. That is because I don't have any idea how
  24.  to support this particular effect. If you have some info about this effect,
  25.  please send me everything you know.
  26.    CapaMod is based on CapaPlay routines which are partly based on Cascada's
  27.  GUSPlay routines. I found GUSPlay's source very handy to edit for my own
  28.  purposes so I started to work on it. I have also studied GusMod and DSMI
  29.  sources. Ok. Here's the thanks list:
  30.  
  31.           Biggest thanks to Robert Adolfsson for GUSPlay
  32.           Other thanks to:
  33.              Joshua Jensen for GusMod
  34.              Otto Chrons for DSMI and DMP
  35.              Jussi Lahdenniemi for PMP
  36.              Christian Kuendig for ZZPlay
  37.              Phantom for ProTracker for GUS
  38.              PSi for MDP and Scream Tracker 3.01 Beta
  39.              Stephan Danes and Ramon von Gorkom for Inertia Player
  40.              Jaakko Lehtinen for JMP
  41.              Mr.H for FastTracker
  42.              Henning Hellström for SB Studio
  43.              Samuel Audet for support and testing
  44.              Jaz for some feature ideas
  45.              Weasel for bug reports
  46.              Oliver Deiter for the condom with two holes
  47.              All Capacala members for beta testing
  48.              Erika Launonen for herself
  49.  
  50.  
  51.      2. THE USAGE
  52.  
  53.    First of all, you must have ULTRASND environment variable set. CapaMod won't
  54.  work without it. And if you still encounter some problems, please make sure
  55.  that you have installed the ULTRINIT, although it is not necassary.
  56.  
  57.    Here's the command line syntax:
  58.  
  59.            CMOD [modname] [@listfile] /options
  60.  
  61.     modname: Module name(s), wildcards allowed
  62.    listfile: A file containing module names
  63.  
  64.     options: Axx     - set amplification (0 - 28, default = 24)
  65.              Pxxx    - set default panning (-64 - 64, default = 18)
  66.              Fx      - set fadespeed (0 - 9, default = 9)
  67.              Lx      - set module looping (0 or 1)
  68.              0       - disable speed zero
  69.              N       - disable pan effects
  70.              V       - use the volume table used in CapaMod versions below 1.16
  71.              Z       - use 80x25 textmode
  72.              B       - disable BPM tempo, speed scale 0-255 (VBlank)
  73.              X[file] - start playing mod and execute [file]
  74.              Sxxxx   - screen saver launch time in seconds (0 = off, default)
  75.              W       - force to Amiga limits (only octaves 1-3)
  76.              R       - disable key repeating speed set
  77.  
  78.    You can also put your favorite command line options into an envrionment
  79.  variable. For example:
  80.  
  81.   SET CAPAMOD=/f0 /0 /n /z /w
  82.  
  83.    CapaMod begins by loading the first module and invoking the main screen. 
  84.  Video mode will be changed to 80x50, unless you have forced the video mode to 
  85.  80x25 with the Z option. On top of screen you can see some useful information 
  86.  about module and location where the player currently is. On the right side 
  87.  there is the clock and the playing time.
  88.    Under this info are the channel indicator lines. They show the sample
  89.  name, effect, volume, pitch and panning of each channel. The volume bars,
  90.  which are also in this section of a screen, are standard module-bars. They
  91.  don't even try to be any kind of VU-meters. Information text is black if the 
  92.  sample is triggered during the current row position. If the currently played
  93.  effect is not supported, it will be shown in red.
  94.    And under all this, there is the sample information. There you can find
  95.  sample names, lengths, loops, finetunes and channel which they are being play-
  96.  ed on. Current sample is highlighted. If sample is muted its information is
  97.  shown in dark colors.
  98.  
  99.    You can use the following keys to control playing and other stuff:
  100.  
  101.               /   -   set module position
  102.               /   -   move cursor
  103.              Tab    -   change cursor location between samples and channels
  104.              Space  -   mute / release a channel or a sample
  105.              M      -   mute / release all channels or samples
  106.              1 - 8  -   mute / release a channel indicated by the numberkey
  107.              F1-F10 -   set fadespeed (F10 fade off) 
  108.              - / +  -   set volume
  109.              , / .  -   set panning of channel
  110.              ; / :  -   set panning of channel 4 steps
  111.            Home/End -   set tempo
  112.             PgD/PgU -   set speed
  113.              Del    -   set speed & tempo determined by the module
  114.              N      -   fade out and load next module,
  115.                         another N stops fading and starts loading immediately
  116.              Esc    -   fade out and quit,
  117.                         another Esc stops fading and quits immediately
  118.              D      -   dos shell
  119.              P      -   pause / release module
  120.              H      -   help and other info
  121.              L      -   switch looping on/off
  122.              0      -   enable/disable speed zero
  123.              < / >  -   scroll screen up / down (only in 80x25 mode)
  124.              Enter  -   stops fading and volume to 64
  125.              S      -   screen saver
  126.  
  127.  
  128.      3. CONTACTING THE AUTHOR (an old cliché)
  129.    
  130.    If you find any bugs or encounter some problems, don't hesitate to contact
  131.  me. You can also just write me a card where you tell how good CapaMod is and 
  132.  how good I am ( just like Otto wants, greets to him by the way ).
  133.  
  134.    And, as mentioned in the player, CapaMod is rubberware. That means if you
  135.  use CapaMod, you must send me a condom from your home country.
  136.  
  137.  
  138.      Mail:  Heikki Ylinen        Modem:  DARKSíDE BBS the Capacala WHQ
  139.             Oravatie 9b                  +358-0-294 1594   node 1
  140.             02270 Espoo                  +358-0-294 0467   node 2
  141.             Finland
  142.  
  143.    You may also find me from some other finnish BBSs. I go by the name of flap
  144.  or Hessu Ylinen. You can also reach me thru DGi-net by the name of Hessu 
  145.  Ylinen.
  146.  
  147.      4. THE END
  148.